impression: tools to manipulate images as "paintings"

TOP | Up | Download | Pheedbak | Tree | Topic | A-Z | Search | Hot | New

the other tools can be used to manipulate paintings stored as a list of brush strokes. these brush stroke files are called "sample sets" and usually have a suffix of ".ss".

Links to other files that may be useful to view follow:

• Makefile
• impression.sh simply try-it-out script
• makegrad.sh create a gradient
• sampset1.sh create and show a sample set
• sampset2.sh create and show another sample set
• showgrad.sh show a gradient

• The main paint program (impression.c) is invoked in the following way:

  impression it.rgb [-o it.ss] [-d dir.bw]

• The program "ssshow" (ssshow.c) can be used to display a sample set:

  ssshow it.ss

• The program "ssrender" (ssrender.c) can render a sample set at any resolution:

  ssrender it.ss rend.rgb 300 200

• "ssrand" (ssrand.c) can be used to add noise to brush stroke directions, positions, etc.:

  ssrand in.ss rand.ss mag -c -d -p -s

  -c: color
  -d: direction
  -p: position
  -s: size

• "ssblend" (ssblend.c) linearly interpolates two paintings -- both paintings should have about the same number of strokes:

  ssblend in1.ss in2.ss out.ss param

• "sscross" (sscross.c) cross disolves between two sample sets:

  sscross in1.ss in2.ss out.ss param

• "sscat" (sscat.c) concatenates several paintings:

  sscat in1.ss in2.ss ... out.ss

• "ssclip" (ssclip.c) clips brush stroke locations to a circle:

  ssclip in.ss out.ss

• "ssgen" (ssgen.c) creates a rectangular array of brush strokes:

  ssgen out.ss nx ny

• "sspntgen" (sspntgen.c) uses a set of point sample locations to generate a sample set:

  sspntgen in.pnts out.ss nx ny

• "ssprint" (ssprint.c) makes a textual description of a painting:

  ssprint in.ss

• "sssample" (sssample.c) samples an image to control brush stroke colors, directions or sizes:

  sssample in.ss out.ss in.rgb [-d] [-s]

• "ssdensity" (ssdensity.c) uses a b/w image to generate a set of sample positions with varying density:

  ssdensity inimage out.ss size

• "ssdomain" (ssdomain.c) displays a sample set on the screen as a set of Dirichlet domains:

  ssdomain infile

• "sstops" (sstops.c) converts a sample set to PostScript for printing:

  sstops infile aspect

• you can scale the color, direction, poisition or size of strokes using "ssscale" (ssscale.c):

  ssscale in.ss out.ss scale

• you can set the brush direction, size and shape for a whole sample set using "ssset" (ssset.c):

  ssset in.ss out.ss val [-d -s -b]

• you can sort brush strokes by color, direction, position and size using "sssort" (sssort.c):

  sssort in.ss out.ss [-c -d -p -s]

• ../imgtools/graddir determines the direction of the gradient across an image. I suggest making "blurpix" ~40, but try small numbers also like 4:

  ../imgtools/graddir in.rgb dir.bw blurpix